Willi Mako Marktkommunikation In Der Energiewirtschaft

Created By
STROMDAO GmbH10 months ago
# Unlocking Business Value in German Energy Market Communication: The Willi MaKo Knowledge Service ## The Challenge: The High Cost of Complex Knowledge Navigating the labyrinth of German energy market communication (MaKo) regulations is a daunting task. The official documentation—spanning thousands of pages across standards like GPKE, MaBiS, and WiM—is dense, complex, and constantly evolving. For businesses operating in this space, accessing and interpreting this information is a significant operational challenge that translates directly into business costs: * **Time & Resources:** Analysts and developers spend countless hours searching for specific rules, process diagrams, and data formats. * **Compliance Risks:** Misinterpretations of the complex rules can lead to costly process failures and penalties. * **Onboarding & Training:** Getting new team members up to speed on the intricate details of market communication is a slow and expensive process. * **Innovation Barrier:** The high barrier to entry for understanding these regulations stifles the development of new, intelligent applications. ## The Solution: Transforming Knowledge into a Strategic Asset The **Willi MaKo Knowledge Service** is an advanced MCP Tool-Server designed to solve this problem. It transforms the entire corpus of MaKo regulations from a complex liability into an instantly accessible, queryable strategic asset. By providing a simple, standardized API, the service empowers developers, consultants, and business analysts to build next-generation applications and workflows that leverage deep, accurate, and context-aware knowledge of the German energy market. ## The Business Value Integrating the Willi MaKo Knowledge Service delivers tangible value across your organization: #### 1. Accelerate Efficiency and Reduce Operational Costs Drastically cut down research time from hours to seconds. Your team can get immediate, precise answers to complex questions like "What are the exact triggers for a supplier change process?" or "What is the structure of an APERAK message for error code Z08?". This frees up valuable expert resources to focus on higher-value tasks. #### 2. Mitigate Compliance Risks Build automated workflows and intelligent assistants that rely on a consistent, accurate, and up-to-date knowledge base. By providing clear, context-rich answers, the service helps prevent costly misinterpretations of market rules and ensures process conformity. #### 3. Empower Informed Decision-Making Enable your teams to make faster, more fundierte strategic decisions. Whether analyzing the impact of a new regulation or designing a new customer process, the service provides the foundational knowledge required to move forward with confidence. #### 4. Enable AI-Powered Innovation The service is the perfect foundation for building sophisticated RAG (Retrieval-Augmented Generation) applications. Create intelligent chatbots for employee training, develop smart assistants for process management, or build automated compliance-checking tools that were previously unfeasible. ## What Makes It Powerful: A Superior Knowledge Base The service's high performance is a direct result of its advanced, multi-layered data processing pipeline: * **Beyond Simple Text Search:** The underlying documents were analyzed for structure and context. Tables are preserved as tables, process diagrams are understood as processes, and visual layouts are interpreted, providing much richer context than simple text chunks. * **Multi-Vector Strategy:** For every piece of information, the knowledge base stores multiple semantic representations, including expert summaries, simplified explanations, and synthetic Q&A pairs. This ensures maximum relevance for any type of query, from a high-level overview to a deeply technical question. * **Full MCP Compliance:** The server implements the complete MCP Tool-Server protocol, offering advanced features like **Tools**, **Templates (Prompts)**, and **Resources** for deep, flexible integration with sophisticated clients like n8n and Claude.ai. ## Getting Started The service is accessible via a standardized MCP endpoint. Clients can discover its capabilities and execute tools through a simple, JSON-RPC 2.0 interface. * **Endpoint**: `https://mcp.stromhaltig.de` * **Protocol**: MCP (JSON-RPC 2.0) ### Quick Start Example: Performing a Search Use the `tools/call` method to execute the `search` tool. The server's root endpoint (`/`) will automatically route the request. ```bash curl -X POST https://mcp.stromhaltig.de \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "search", "arguments": { "query": "How does the supplier change process work?", "top_k": 2 } } }' ``` This will return a structured, context-rich answer, ready to be used in your application. ```
Overview

Willi MaKo Knowledge Service

Überblick

Ein spezialisierter MCP Tool-Server, der eine hochoptimierte semantische Suche in der komplexen Wissensdatenbank der deutschen Energie-Marktkommunikation (MaKo) ermöglicht. Beantworten Sie komplexe Fragen zu GPKE, MaBiS, WiM und anderen EDI@Energy-Dokumenten in Sekundenschnelle.

  • Endpunkt: https://mcp.stromhaltig.de
  • Protokoll: MCP (JSON-RPC 2.0)
  • Maintainer: [Ihr Name/Ihre Organisation hier eintragen]

Zielgruppe

Entwickler, Berater und Fachanalysten im deutschen Energiesektor, die RAG-Anwendungen (Retrieval-Augmented Generation) erstellen oder schnellen, kontextbezogenen Zugriff auf die MaKo-Regularien benötigen.

Hauptmerkmale

Dieser Service geht weit über eine einfache Textsuche hinaus und bietet eine qualitativ hochwertige Datenbasis durch:

  • Multi-Layer-Extraktion: Die zugrundeliegenden PDF-Dokumente wurden nicht nur als Text, sondern auch auf struktureller Ebene analysiert. Tabellen, Diagramme und visuelle Layouts wurden mit KI-Modellen erfasst und als reichhaltiger Kontext gespeichert.
  • Multi-Vektor-Strategie: Für jede Information existieren mehrere Vektor-Repräsentationen (Experten-Zusammenfassungen, Einsteiger-Erklärungen, synthetische Q&A-Paare), um eine maximale Treffergenauigkeit für unterschiedlichste Anfragen zu gewährleisten.
  • Vollständige MCP-Konformität: Der Server implementiert die fortgeschrittenen MCP-Features Tools, Templates (Prompts) und Resources, was eine tiefe und flexible Integration in moderne Clients ermöglicht.

Verfügbare Tools

Das primäre Werkzeug zur Durchführung einer semantischen Suche.

Input-Schema:

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Die Frage in natürlicher Sprache"
    },
    "top_k": {
      "type": "number",
      "description": "Maximale Anzahl der Ergebnisse",
      "default": 5
    }
  },
  "required": ["query"]
}

Verfügbare Templates (Prompts)

Der Server bietet vordefinierte Prompt-Vorlagen an, die mit dynamischem Kontext aus der Wissensdatenbank angereichert werden können:

  • knowledge-search: Führt eine strukturierte Suche durch und bereitet den Kontext auf.
  • comparative-analysis: Stellt Informationen für eine vergleichende Analyse zweier Themen zusammen.
  • deep-dive: Führt eine umfassende, mehrstufige Recherche zu einem spezifischen Thema durch.

Quick Start: Eine Suche durchführen

Sie können den Service direkt mit curl testen. Führen Sie den folgenden Befehl aus, um eine Suche nach dem Prozess des Lieferantenwechsels durchzuführen:

curl -X POST https://mcp.stromhaltig.de \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search",
      "arguments": {
        "query": "Wie funktioniert der Lieferantenwechsel?",
        "top_k": 2
      }
    }
  }'

Hinweis: Der Root-Endpunkt (/) leitet die Anfrage basierend auf dem method-Feld an den korrekten internen Endpunkt (/tools/call) weiter.

Server Config

{
  "mcpServers": {
    "default-server": {
      "type": "streamable-http",
      "url": "https://mcp.stromhaltig.de",
      "note": "For Streamable HTTP connections, add this URL directly in your MCP Client"
    }
  }
}
Project Info
Created At
10 months ago
Updated At
10 months ago
Author Name
STROMDAO GmbH
Star
-
Language
-
License
-
Category

Recommend Servers

View All
GovQL
@Alex Stout

# govql-mcp-server An MCP (Model Context Protocol) server for [GovQL](https://govql.us) — gives AI clients like Claude Desktop, Claude Code, and Cursor direct access to the US Congressional GraphQL API at [api.govql.us/graphql](https://api.govql.us/graphql) without bespoke HTTP wiring. For the design rationale (why FastMCP-Python, the passthrough+curated philosophy, roadmap through v0.4), see [design.md](https://github.com/govql/govql/blob/main/mcp-server/docs/design.md). ## What you can do with it Ask an agent questions like: - *"How did Vermont's two senators vote on the most recent nomination?"* - *"Which legislators in the 118th Congress switched parties during their service?"* - *"Compare Senator Sanders' voting record to Senator Murkowski's on cloture votes in the most recent Congress."* The agent picks the right tool, writes the GraphQL query against the live schema, and parses the response — no manual API wrangling. ## Install The server runs as a per-client subprocess over stdio. Pick your client: ### Claude Desktop Edit `claude_desktop_config.json` (Settings → Developer → Edit Config): ```json { "mcpServers": { "govql": { "command": "uvx", "args": ["govql-mcp-server"] } } } ``` Restart Claude Desktop. The `govql` tools appear in the tools panel. ### Claude Code Add to `.mcp.json` in your project (or `~/.mcp.json` for global): ```json { "mcpServers": { "govql": { "command": "uvx", "args": ["govql-mcp-server"] } } } ``` ### Cursor Settings → MCP → Add Server. Use the same `command` / `args` as above. ### Other clients Any MCP-compatible client that supports stdio servers will work. The command is `uvx govql-mcp-server` with no required arguments. ## Tools | Tool | Purpose | |---|---| | `execute_graphql` | Run any GraphQL query against the GovQL endpoint. Returns the result plus an `last_ingest` timestamp so the agent can reason about data freshness. | | `list_types` | Returns the names and kinds of every type in the GovQL schema. Optional `kind` filter (`"OBJECT"`, `"INPUT_OBJECT"`, `"ENUM"`, etc.) to narrow further. Start here when you don't know what's queryable. | | `describe_type` | Returns one type's full details — fields, arg signatures, input fields, enum values. Call after `list_types` to learn the shape of a specific type before writing a query. | ## Configuration All env vars are optional — the package is zero-config for end users. | Env var | Default | Purpose | |---|---|---| | `GOVQL_ENDPOINT` | `https://api.govql.us/graphql` | Endpoint to query. Override to point at a local dev stack. | | `GOVQL_TIMEOUT_MS` | `30000` | Per-request HTTP timeout. | | `LOG_LEVEL` | `INFO` | Logging level. Logs go to stderr only (stdout is reserved for the MCP transport). | ## Limits (enforced by the upstream API) - Max query depth: 10 - Max query complexity: ~10 billion points (`first: N` multiplies child cost by N — keep page sizes reasonable on deeply nested queries) - Rate limit: 100 requests / 60 s per source IP A depth or complexity violation surfaces as a GraphQL `errors` entry in the tool response so the agent can adjust and retry. ## Data freshness Every `execute_graphql` response includes a `last_ingest` ISO timestamp. Vote data refreshes hourly; legislator data refreshes daily. ## Status Version 0.1.0 ships three foundational tools: a GraphQL passthrough (`execute_graphql`) and two narrow schema-discovery tools (`list_types`, `describe_type`). Curated higher-level tools (`find_legislator`, `get_voting_record`, `compare_voters`, etc.) are planned for subsequent releases — see [design.md](https://github.com/govql/govql/blob/main/mcp-server/docs/design.md) for the roadmap. ## Links - [GovQL project site](https://govql.us) - [GraphQL API](https://api.govql.us/graphql) - [Source / issues](https://github.com/govql/govql)

2 days ago
Tavily Mcp
@tavily-ai

JavaScript
a year ago